Sourced from sigs.k8s.io/controller-runtime's releases.

v0.15.0

Controller Runtime v0.15

A note from the maintainers

The following release is probably the largest in the history of the project. Controller Runtime is a foundational piece for almost all controllers and operators and we're aware that breaking changes are never an ask for our users, especially while running production services.

We take breaking changes very seriously and carefully reviewed each one of these changes to improve the codebase, user experience, and future maintainability of the project.

The v0.15 release is a stepping stone towards maturity.

As always, please reach out in Slack in #controller-runtime.

Changes since v0.14.5

⚠️ Breaking Changes

• Make *http.Client configurable and use/share the same client by default (#2122)
  • When using the default Manager configuration, no immediate changes are needed.
  • client/apiutil.NewDynamicRESTMapper signature has changed and now requires an *http.Client as parameter.
  • cluster.Cluster interface requires GetHTTPClient() method which must return an already configured, non-nil, *http.Client for the Cluster. When using cluster.New to create Clusters, the client is created internally if not specified as an Options field.
  • cluster.Options.MapperProvider field now requires a *rest.Config and *http.Client.
• Deprecate Component Configuration config/v1alpha1 types (#2149, #2200)
  • The Component Configuration package has been unmaintained for over a year and is no longer actively developed. There are (currently) no plans to revive the package, or provide an alternative.
  • Users should migrate to a custom implementation that sets Manager.Options directly.
  • 👉 Feedback requested: removal of the deprecated types and code is tracked in #895.
• Remove dependency injection functions (#2134, #2120)
  • The package pkg/inject has been removed, this package contained long deprecated injection functions (like InjectScheme, InjectLogger, InjectConfig, InjectClient, InjectCache, etc.).
  • The runtime injection functionality has been deprecated since Controller Runtime 0.10; all of the above fields can be passed from the Manager to structs or interfaces that need them.
• Improve builder package capabilities and general UX (#2135)
  • builder.Builder.Watches signature has changed, it now takes a client.Object instead of a source.Source as first argument.
    • For source.Source, use WatchesRawSource.
  • builder.Builder.WatchesMetadata has been added to simplify watching PartialObjectMetadata objects.
• Refactor cache.Options, deprecate MultiNamespacedCacheBuilder (#2157, #2166)
  • cache.Options.Namespace has been removed in favor of cache.Options.Namespaces, a slice.
  • cache.Options.Resync has been renamed to SyncPeriod.
  • cache.Options.DefaultSelector has been removed and split in two fields:
    • cache.Options.DefaultLabelSelector
    • cache.Options.DefaultFieldSelector
  • cache.Options.DefaultTransform was added to provide a global transform function.
  • cache.Options.UnsafeDisableDeepCopy was added to provide a global toggle to disable DeepCopy of the objects from the cache before returning them to clients.
  • The following [..]ByObject field have been refactored:
    • cache.Options.SelectorsByObject has been removed, use cache.Options.ByObject[Object].Field and cache.Options.ByObject[Object].Label
    • cache.Options.UnsafeDisableDeepCopyByObject has been removed, use cache.Options.ByObject[Object].UnsafeDisableDeepCopy.
    • cache.Options.TransformByObject has been removed, use cache.Options.ByObject[Object].Transform.
  • cache.ObjectAll has been removed. This type was previously used to set selectors or transformation functions for every object, use the newly introduced default global options instead.
• Add context to EventHandler(s) (#2139)
  • handler.EventHandler and handler.Funcs interfaces require context.Context as the first parameter for every method.
  • handler.MapFunc signature has changed and now requires a context.Context.
• Add client.{GroupVersionKindFor, IsObjectNamespaced} (#2136)
  • The client.Client interface now requires and exposes these helper functions:

... (truncated)

• 116a1b8 Merge pull request #2340 from kubernetes-sigs/dependabot/go_modules/github.co...
• 96bf7c3 🌱 Bump github.com/onsi/gomega from 1.27.6 to 1.27.7
• f9a3164 Merge pull request #2338 from howardjohn/mod/bump-jsonpatch
• 73ae72f 🌱 bump jsonpatch to v2.3.0
• e7b9407 Merge pull request #2334 from sbueringer/pr-webhook-log-levels
• babed98 Reduce webhook log verbosity
• 260b822 Merge pull request #2333 from lucacome/tests-0.27.2
• c8b911b Re-enable tests for v0.27.2
• 1fe22d0 Merge pull request #2330 from lucacome/bump-k8s.io-deps
• 0cc8dd8 Bump k8s.io dependencies
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)